GET Audios

Overview

---

The following table contains information about the GET method for managing the proccess of retrieving all audios as a list.

GET Audios
Method	GET
URL or Endpoint	/api/v1/projectId/audios
Headers	Authorization
Parameters	projectId, search, order, insertedDate, page, take, folderId, folderview, onlyReady, onlyPublishedAudios, key, value, author, podcastId
Body	Not Applicable

The description of the URL parameters is as follows:

URL Parameter Name	Mandatory	Type	Description
projectId	Yes	string	Unique ID of the project.

The description of the parameters is as follows:

Parameter Name	Mandatory	Type	Description
folderId	No	integer	Unique identifier of the folder
folderView	No	boolean	Indicates wether the folder is enabled for viewing
onlyReady	No	boolean	Includes only audios that have status ready
onlyPublishedAudios	No	boolean	Inludes only audios that are published
key	No	string	Audio key
value	No	string	Value of the audio key
search	No	string	Search a specific audio
order	No	string	Specifies the sorting order.
insertedDate	No	string($date-time)	Date when the audio was inserted.
page	No	integer	A specific page with audios.
take	No	integer	Number of audios to take.
author	No	string	Filter audios by author.
podcastId	No	string	Filter audios by podcast identifier.

Request Body

The GET method doesn't contain a request body.

Response

{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "currentPage": 1,
    "totalPages": 8,
    "pageSize": 10,
    "totalCount": 72,
    "items": [
      {
        "title": "{title}",
        "publicId": "{audioId}",
        "author": "{author}",
        "audioAuthor": "{audioAuthor}",
        "deletedBy": "{deletedBy}",
        "status": "Ready",
        "publishDate": "2024-03-05T22:35:00",
        "updateDate": "2024-03-05T22:35:00",
        "canEmbed": true,
        "thumbnail": "{thumbnailUrl}",
        "duration": 15.072653,
        "folderId": 0,
        "folder": "{folder}",
        "progress": 0,
        "estimatedFinishTime": "{estimatedFinishTime}",
        "showEncodingProgress": false,
        "errorId": 0,
        "error": "{error}",
        "highlight": {}
      }
    ]
  },
  "resultInfo": null,
  "statusCode": 200
}

Information about the fields that appear when you receive the response are displayed in the table below.

Top-Level Properties

Field Name	Type	Description
success	boolean	If the response is successful it will return true. Otherwise will return false
errors	array[string]	Indicates if there was an error
messages	array[string]	Returns the response message from back-end
result	object	Returns the response object
currentPage	integer	Number of the current page
totalPages	integer	Number of the total page
pageSize	integer	The size of the page
totalCount	integer	Number of the total records
items	array[object]	Array of audio objects on the current page.
resultInfo	string	Returns extra information about the result
statusCode	integer	Returns the HTTP Status Code

items Properties

Field Name	Type	Description
title	string	Title of the audio
publicId	string	Unique identifier of the audio
author	string	Author of the audio
audioAuthor	string	Author of the audio content
deletedBy	string	The user who deleted the audio.
status	string	Status of the audio
publishDate	string	Publish date of the audio
updateDate	string	Date when the audio was last updated.
canEmbed	boolean	Indicates if the audio can be embedded
thumbnail	string	Thumbnail of the audio
duration	double	Duration of the audio in seconds
folderId	integer	Identifier of the folder
folder	string	Folder details
progress	double	Progress of the audio processing
estimatedFinishTime	string	Estimated finish time for processing
showEncodingProgress	boolean	Indicates if encoding progress should be shown
errorId	integer	Unique identifier for the error
error	string	Description of the error
highlight	object	Highlight information

info

For more information about the possible errorId and error values, see Error Codes.

If the action is successful, the service sends back an HTTP 200 or 201 response.

Errors

For information about the errors that are common to all actions, see Common Errors:

• HTTP Status Code 400: Bad Request

• HTTP Status Code 401: Unauthorized

• HTTP Status Code 403: Forbidden

• HTTP Status Code 404: Result Not Found

• HTTP Status Code 500: Internal Server Error

• HTTP Status Code 503: Backend Fetch Failed